home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / GENSCR.ZIP;1 / VERSION.TXT < prev   
Encoding:
Text File  |  1993-08-10  |  12.6 KB  |  294 lines
  1. GENSCRNX VERSION UPDATE LOG
  2.  
  3.  
  4.                                  1.6b
  5.                                 ------
  6. New:  *:GENSCRNX <file>
  7.       *:GENSCRNX is used to specify which program is used to generate 
  8.       screen code.  *:GENSCRNX overrides any _GENSCRNX in the
  9.       CONFIG.FP/CONFIG.FPW files.  If both *:GENSCRNX and _GENSCRNX are not
  10.       specified, the default setting is GENSCRN.PRG located in FoxPro's
  11.       start-up directory.  *:GENSCRNX can be used to specify a modified
  12.       GENSCRN needed for a particular screen rather than changing _GENSCRN
  13.       before generating a screen.
  14.  
  15. New:  *:DELOBJ
  16.       Delete screen object at compile time after pre-processing is complete.
  17.       Use *:DELOBJ for objects that need to reside in the .SCX database
  18.       during pre-processing but not in the .SPR file at run-time.
  19.  
  20. Fix:  The insertion of a file using #:INSERTTOP <file> when one platform
  21.       of source code is generated is placed after the .SPR file comment
  22.       heading rather than before.  This is not a functionality fix, but
  23.       rather a cosmetic fix.
  24.  
  25. ---------------------------------------------------------------------------
  26.  
  27.  
  28.                                  1.6a
  29.                                 ------
  30.  
  31.  
  32. New:  #:INSERTTOP <file>
  33.       Inserts file at top of .SPR code before DO CASE of cross-platform
  34.       block.  If #:INSERTTOP <file> appears more than once due to
  35.       cross-platform snippets containing the same code, the <file> will
  36.       only be inserted into the .SPR once.  This allows header files
  37.       containing #DEFINE directives to be inserted once per .SPR file
  38.       instead of one per platform inside the DO CASE block.
  39.  
  40. New:  The AUTORUN function can now be set by either adding AUTORUN=ON in
  41.       the CONFIG.FP/CONFIG.FPW file or setting a public variable
  42.        _AUTORUN='ON'.  Placing *:AUTORUN in the Setup snippet overrides
  43.        AUTORUN=OFF in CONFIG.FP/CONFIG.FPW.  Placing *:NOAUTORUN in the
  44.        Setup snippet overrides AUTORUN=ON in CONFIG.FP/CONFIG.FPW.
  45.  
  46. New:  The *:EVLTXT directive is automatically and is no longer a GENSCRNX
  47.       directive.  Evaluation of any {{<expC>}} command contained in memo
  48.       fields are automatically evaluated.
  49.  
  50. New:  *:PJXSET
  51.       Place in the Setup snippet before the *:PRG directive or any *:SET
  52.       directive to force the project information to have priority settings
  53.       when building the screen from a project.
  54.       Example:
  55.       If the following was in the Setup snippet of a screen:
  56.       *:SET MODAL ON
  57.       *:PJXSET
  58.       *:SET READCYCLE OFF
  59.       Then if the screen was generated from the Screen Builder, the READ
  60.       would contain the clauses MODAL and CYCLE no matter what the check
  61.       box settings were set to before selecting <Generate>.  If the screen
  62.       was generated from a project, the READ would contain MODAL no matter
  63.       what the settings were set to in the project but the CYCLE setting
  64.       would be set to whatever the project setting was set to.
  65.  
  66. New:  When using *:BASOBJ and snippet type is different between library
  67.       and screen surface, the procedure snippet is automatically placed
  68.       into the Cleanup snippet as a unique function and the function
  69.       name is added to the expression.
  70.  
  71. Fix:  *:IF works properly when used with *:INSSCX or *:INSOBJ directives.
  72.  
  73. Notes:  If #SECTION 1 is in the Setup snippet, then #:INSERT and #:INSERTTOP
  74.         must be placed after the #SECTION 1 statement.
  75.  
  76. Notes:  If COMPSPR=ON and DISPSPR=ON and an .ERR file is created forcing
  77.         GENSCRNX to display the .SPR and .ERR files, then the window with
  78.         the .SPR file must be closed before re-generating the .SCX when
  79.         SHARE.EXE is loaded to avoid a sharing violation error.
  80.  
  81. Notes:  GENSCRNX automatically searches the Setup snippet and Comment
  82.         snippets for any *: or {{ characters to determine of the .SCX
  83.         database needs pre-processing.  Therefore, if any {{<expC>}} need
  84.         to be evaluated and are not in the Setup snippet or Comment
  85.         snippets, they may not be evaluated properly.  If the GENSCRNX
  86.         error mode appears or pre-processing is not being performed when
  87.         it needs to be, simply place *: on any line in the Setup snippet
  88.         to force GENSCRNX to pre-process the .SCX database.
  89.  
  90. ---------------------------------------------------------------------------
  91.  
  92.  
  93.                                  1.6
  94.                                 ------
  95.  
  96.  
  97. New:  *:AUTORUN
  98.       Automatically releases screen after generation and execute generated
  99.       file.  *:AUTORUN is automatically disabled if either a compiled file
  100.       is not properly generated or a compile error was detected via the
  101.       COMPSPR=ON.
  102.  
  103. New:  *:COMPSPR
  104.       Overrides COMPSPR=OFF in CONFIG.FP/CONFIG.FPW.
  105.  
  106. New:  *:DISPSPR
  107.       Overrides DISPSPR=OFF in CONFIG.FP/CONFIG.FPW.
  108.  
  109. New:  *:ENDFNCT
  110.       Place at end of code that follows *:FUNCTION to mark ending of text.
  111.       *:ENDTXT is now used with *:INSTXT and is not used with *:FUNCTION.
  112.  
  113. New:  {{< <file> }}
  114.       Insert a file at compile time.  The < that follows the open braces is
  115.       the command that evaluates the contents of a file and inserts the file
  116.       at that location.  Note:  The inserted file may contain {{ <expC} }}
  117.       to be evaluated.
  118.       
  119. New:  {{ <expC1> :: [<expC2>] [:: <expC3>] }}
  120.       Insert code from a screen or library object.  <expC1> is the
  121.       library.object name just as in *:DEFOBJ, *:BASOBJ, etc.  Note if the
  122.       library name is not included, the object is searched for specified by
  123.       the *:INCLIB and *:BASLIB directives in the Setup snippet.  Also, if a
  124.       matching object is defined via the *:DEFOBJ directive on the surface
  125.       screen, that object will have proirity over any matching library
  126.       objects.  <expC2> is the string to be evaluated.  After the .SCX
  127.       record is matched, any string can be evaluated (ex. 'VALID' to return
  128.       the VALID snippet).  If <expC2> is null, the COMMENT contents will
  129.       be returned.  <expC3> is the option method name.  If <expC3> is
  130.       included, the text block specified by the matching method defined by
  131.       *:METHOD <name> ... *:ENDMTHD is returned.
  132.  
  133. New:  *:METHOD
  134.       Place at start of code to mark beginning of method code.
  135.  
  136. New:  *:ENDMETHOD
  137.       Place at end of the code that follows *:METHOD to mark ending of
  138.       text.
  139.  
  140. Fix:  Fix for incorrect generation of Setup snippets when screen sets
  141.       contain more than one screen that are pre-processed by GENSCRNX.
  142.  
  143. Fix:  Proper execution for multiple *:INSOBJ directives.
  144.  
  145. Notes:  GENSCRNX default behavior does not add * Start of text and * End
  146.         of text messages for the *:INSTXT directive for enhanced
  147.         performance.  To add the commented text (as in version 1.5 and
  148.         earlier) either set OUTTXT=ON in the CONFIG.FP/CONFIG.FPW file or
  149.         set a public variable _OUTTXT='ON'.
  150.  
  151. Notes:  *:OBJNAM has been renamed to *:DEFOBJ.  For an example, refer
  152.         to the COLOR text object in the sample screen CUST4.SCX.
  153.  
  154. ---------------------------------------------------------------------------
  155.  
  156.  
  157.                                  1.5
  158.                                 -----
  159.  
  160.  
  161. New:  #:SECTION 3
  162.       Used in Setup snippet (like #SECTION 1 | 2) to insert code after GETs
  163.       and before READ in the Screen Layout.  For an example, refer to
  164.       CUST5.SCX.
  165.  
  166.  
  167. New:  *:FUNCTION <function name>
  168.       Used in Comment snippet of object to automatically insert a function
  169.       into the Cleanup snippet.  Function needs to be written just like a
  170.       typical FoxPro UDF except that *:FUNCTION is used instead of FUNCTION.
  171.       GENSCRNX will automatically remove the *: from *:FUNCTION.  Only on
  172.       *:FUNCTION can exist per Comment snippet.
  173.  
  174.  
  175. New:  *:ENDTXT
  176.       Place at end of the code that follows *:INSTXT or *:FUNCTION to mark
  177.       ending of text to be inserted.
  178.  
  179.  
  180. New:  *:SAVESIZE
  181.       Used with *:DEFOBJs to force the SIZE information to be retrieved from
  182.       the library when the object is based in a screen.  For an example, refer
  183.       to the PHONE object in the MAIN library (LIBMAIN1.SCX).
  184.  
  185.  
  186. New:  *:SAVEPICT
  187.       Used with *:DEFOBJs to force the PICTURE information to be retrieved from
  188.       the library when the object is based in a screen.  For an example, refer
  189.       to the CONTROL_BAR_ object in the MAIN library (LIBMAIN1.SCX).
  190.       
  191.  
  192. New:  *:BASBEFORE
  193.       Used with *:DEFOBJs to force any inherited expressions or procedures to be
  194.       inserted before rathre than appended after to any screen surface code.
  195.  
  196.  
  197. New:  Referenced library objects can mix expressions and procedures.  The
  198.       expressions are automatically converted to IF/ENDIF blocks.  For example,
  199.       if a VALID object is in the library as an expression and in a screen
  200.       surface is inheriting that object but has a procedure VALID snippet, the
  201.       expression from the library will be converted to an IF/ENDIF block and
  202.       appended to the screen snippet (unless *:BASBEFORE which will force the
  203.       library expression to be inserted before).  If *:BASOBJ is used to
  204.       inherit snippet(s) from a library and the snippet type of the screen
  205.       object snippet is not equal to the snippet type of the library object
  206.       snippet, the snippet that is a function is automatically converted
  207.       into a procedure and appended to obtain the same functionality.
  208.  
  209.  
  210. New:  *:PRG
  211.       A Setup snippet directive called *:PRG that is used to automatically
  212.       change the .SPR extension to a .PRG extension and also add the
  213.       #NOREAD PLAIN directive to the Setup snippet.  The *:PRG directive
  214.       used in conjunction with screen objects with the *:INSTXT directive
  215.       will allow a .PRG file to be created that has no GETs, SAYs, or READ,
  216.       while the screen builder Object Order controls the order of the FoxPro
  217.       source code generated in the .PRG file.
  218.  
  219.  
  220. New:  Improved error handle routine
  221.         Cancel, Ignore, Suspend options
  222.         Error line can be copied from error window into the clipboard
  223.         Display of current open database, ALIAS, and record number
  224.  
  225. New:  Improved warning handle routine
  226.         Cancel, Ignore, Suspend options
  227.  
  228. New:  Warning message defaults to cancel GENSCNRX
  229.         To override, set AUTOHALT=OFF in the CONFIG.FP/CONFIG.FPW
  230.  
  231. New:  A function in GENSCRNX to allow a public variable or CONFIG.FP/
  232.       CONFIG.FPW setting to globally enable/disable drivers.
  233.       Example:  To disable the 3D driver globally:
  234.         1)  Place 3D=OFF in the CONFIG.FPW file
  235.         2)  Set a public variable _3D='OFF'
  236.         Note:  The public variable overrides the CONFIG.FPW setting
  237.  
  238.  
  239. New:  *:OBJNAM <expC>
  240.       For use with the objdata() function for object locating at compile time.
  241.  
  242.  
  243. Fix:  *:IF and *:INSTXT works properly for SAY(Refresh) objects.  Code is
  244.       inserted in both Screen Layout and Read Show sections.
  245.  
  246. Fix:  Building from projects with non-normal ordered records
  247.  
  248. Fix:  Temporary .SCX, .PJX, and .MEM file names created during GENSCRNX are
  249.       unique instead of fixed for network compatibility.
  250.  
  251. Fix:  Proper output of Setup snippet for cross-platform screens when the
  252.       snippets are different and PLATONLY=ON in the CONFIG.FP/CONFIG.FPW
  253.       or a public variable _PLATONLY='ON'
  254.  
  255. Fix:  Fix for *:SIZE directive with EDIT objects and refreshed SAY objects
  256.  
  257. Fix:  Fix for *:SIZE directive with refreshed SAY objects
  258.  
  259. Fix:  Fix for *:INSSCX directive when object is smaller than template
  260.  
  261. Notes:  The *:NOSIZE directive is ignored for EDIT objects
  262.  
  263. Notes:  For WINMOVE.PRG driver, specify *:SCXDRV2 WINMOVE in Setup snippet
  264.  
  265. Notes:  For NOSIZE.PRG driver, specify *:SCXDRV3 NOSIZE in Setup snippet
  266.  
  267. Notes:  For 3D.PRG driver, specify *:SCXDRV5 3D in Setup snippet
  268.  
  269. Notes:  The following .PRG files previously contained in GSXSAMPL.ZIP
  270.         sample code are now contained inside of GENSCRNX:
  271.         OBJDATA.PRG, OBJSAY.PRG, OBJPOS.PRG, LIBDATA.PRG
  272.         The above files should be deleted if the exist from previous
  273.         GSXSAMPL.ZIP sample code.
  274.  
  275. ---------------------------------------------------------------------------
  276.  
  277.  
  278.                                  1.4a
  279.                                 ------
  280.  
  281.  
  282. Fix:  _SCXDRVn and _SPRDRVn in CONFIG.FP/CONFIG.FPW for cross-platform screens
  283.  
  284. Fix:  GENSCRNX should pre-process .SCX if _SCXDRVn is in CONFIG.FP/CONFIG.FPW
  285.       even when no GENSCRNX directives exist in the .SCX
  286.  
  287. Fix:  Building from projects with header record not RECNO()=1
  288.  
  289. Fix:  Proper output of Setup snippet for cross-platform screens when the
  290.       snippets are different
  291.  
  292.  
  293. ---------------------------------------------------------------------------
  294.